home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu093.dms / pu093.adf / SEKA < prev    next >
Text File  |  1994-10-31  |  13KB  |  377 lines
  1. --------------------------------------------------------------------
  2. -------------  Welcome to the SEKA V3.2 instructions  --------------
  3. --------------------------------------------------------------------
  4.  
  5. Welcome to the SEKA V3.2 instructions, first the old instructions
  6. (if you aren't familiar with my old SEKA V3.0).
  7.  
  8. Old SEKA V3.0 instructions:
  9. ---------------------------
  10.  
  11. The SEKA V3.0 is based on the SEKA V1.5 not the SEKA V2.1 by MFC.
  12. Anyhow this version supports all SEKA V2.1 commands. The upgrade
  13. programming was done by Promax of Kefrens.  This is not a course
  14. in how to use the Seka, only a upgrade instructions to the new
  15. commands.
  16.  
  17. Summary of SEKA V2.1 improvements supported by SEKA V3.0:
  18.  
  19. 1. Workspace:
  20.    ----------
  21.    Pressing return by accidence when you are asked 'WORKSPACE>'
  22.    allocates normaly ( 0 kbytes user memory ).  Pressing return
  23.    by accidence will now just repeat the question.
  24.  
  25. 2. Write Object:
  26.    -------------
  27.    When writing an object code you are asked to enter a mode.
  28.    Type the letter c and your object code will allways be loaded
  29.    into the chip-ram when loaded from the cli.  This insures that
  30.    bitmaps and copper list will work on a machine with memory
  31.    expansion.
  32.  
  33. 3. Execute:
  34.    --------
  35.    Typeing '@' enables you to executes a command on the disk,
  36.    like in the CLI.  Please note that the CLI command RUN must
  37.    be present in the c-directory.  You use it like this:
  38.  
  39.               SEKA>@
  40.               EXECUTE>Type DF0:SekaV3.0txt
  41.  
  42.    The output from this command is of course directed to the Seka
  43.    window !!  Not like in the SEKA V2.1 in the AmigaDOS window.
  44.  
  45. 4. >Extern and y:
  46.    --------------
  47.    Typeing the command 'y' execute all >EXTERN commands in your
  48.    source code.  The extern command is used in stead of the 'ri'
  49.    command.  Type in your source code:
  50.  
  51.             9  
  52.            10  >EXTERN "filename",start [ , length ]
  53.            11  
  54.  
  55.                start    = where to load the file
  56.                length   = the desired load length. If you want to
  57.                           the intire file in its default length,
  58.                           skip the length indication.
  59.  
  60.    The start and length pointer may be both labels and direct
  61.    pointers or a mixture of both.  If you use labels you must
  62.    offcourse remember to assemble before typing 'y'.
  63.  
  64. 5. Look in source:
  65.    ---------------
  66.    The 'L' command doesn't differ between lowercase and uppercase.
  67.  
  68. 6.Hyper fast scrolling:
  69.    ---------------------
  70.    Press CTRL+A and you scroll up 100 lines. Press CTRL+Z and you
  71.    scroll down 100 lines.
  72.  
  73.  
  74. Summary of SEKA V3.0 improvements not included in the SEKA V2.1:
  75.  
  76. 1. Copy (debugged):
  77.    ----------------
  78.    The line command 'c'-copy is fixed, there were a bug in
  79.    the two way copy selection, that made the Seka destroy the
  80.    copied data.
  81.       In earlyer SEKA versions pressing return accidentialy caused
  82.    a system crash!  This error is corrected.
  83.  
  84. 2. Fill (debugged):
  85.    ----------------
  86.    Like the Copy command pressing return caused a systemcrash.
  87.  
  88. 3. Copy Link file:
  89.    ---------------
  90.    The copy link file commando 'CL' had the same error as fill.
  91.  
  92. 4. Breaking Seka commands:
  93.    -----------------------
  94.    Pressing Ctrl+C breaks any Seka action.  In earlier Seka
  95.    versions, it was not possible to break the directory function.
  96.  
  97. 5. Chip, Fast or Abs memory:
  98.    -------------------------
  99.    This function enabels you to specify your program memory type.
  100.    If you are making programs with copperlists ect. that requers
  101.    chip-ram, type a 'c'.  If you want your code in the fast-ram
  102.    if you got any type 'f'.  Typing 'f' or just pressing return
  103.    allocates memory as usual. (default for Seka V1.5).
  104.    These options were also avarialbe on the Seka V2.1.  The new
  105.    achevement is the Abs-mem option.  Typing an 'a' enables you
  106.    to type in the address where to allocate the user memory --
  107.    where to put your programs.
  108.  
  109. 6. Friendly Directory:
  110.    -------------------
  111.    Using the 'v' command waited a long time before it printed the
  112.    directory.  This is corrected, and the names is printed out as
  113.    soon as they are loaded, one by one.
  114.  
  115. 7. Assemble-Optimize:
  116.    ------------------
  117.    The line command 'a'-assemble with the Option 'O'-optimize
  118.    specified had two bugs. Before BRA when optimized became BR.SA
  119.    instead of BRA.S and a BRA.L were not made into a BRA.S to
  120.    check if this shorter range were possible.  These errors are
  121.    now fixed.
  122.  
  123. 8. Repeat last line.
  124.    -----------------
  125.    Pressing CRSR-UP repeats last line like usual, but tabs are now
  126.    repeated like a normal char.
  127.  
  128. 9. Write Block.
  129.    ------------
  130.    Pressing CTRL+W in the editor (write block) didn't work.  Now
  131.    this function is fixed.  Mark your block as usual, in stead of
  132.    pressing CTRL+C (cut block) press CTRL+W.  You will not be
  133.    faced with the prompt FILENAME>.  Type a name and your block
  134.    is saved at the disk.
  135.  
  136. 10.Hunt in memory:
  137.    ---------------
  138.    The old line command 'h' is moved and is now called '=', this
  139.    has made space for a new command called 'h'-hunt. This is
  140.    a hunt in memory command.  Try to type:
  141.  
  142.               SEKA>h
  143.               BEGIN>$40000      (address or label)
  144.               END>$50000        (      ----      )
  145.               DATA>"hello",$A   (string in ascii or bytes seperated
  146.                                      with:  <space> or , or + )
  147.  
  148.    If you by accidence have searched for data that occures a lot
  149.    of times in memory.  The hunt command can be breaked by pressing
  150.    CTRL+C.
  151.  
  152. 11.Print command:
  153.    --------------
  154.    Typeing '?' in the SEKA V2.1 printed the hex, dec and bin value.
  155.    Now this version also prints the ascii characters.
  156.  
  157. 12.PAL & NTSC:
  158.    -----------
  159.    This version of the SEKA features automatic PAL and NTSC selection.
  160.    If you start up in PAL the window is automatically opened at full
  161.    256 lines.
  162.  
  163. 13.Edit window:
  164.    ------------
  165.    Pressing ESC activates the edit window. Now a bigger edit window
  166.    is given to you.  In pal = 22 lines ( ntsc = 19 lines ).  Now
  167.    this could cause a problem because a 'q' in memory displays 8
  168.    lines and this bigger window deletes some of these lines.  To
  169.    solve this problem I have given the key just below the ESC key
  170.    marked ` a new function.  Pressing this key opens a smaller edit
  171.    window pal = 13 lines ( ntsc = 10 lines ).  In the editor this
  172.    key is back normal, so you can still use the character ` in your
  173.    programs.
  174.  
  175. 14.Edit scrolling:
  176.    ---------------
  177.    Pressing the shift together with one of the cursor keys, scroll
  178.    the edit display one full screen up or down.  This function can
  179.    also be achieved by pressing CTRL+E (up) or CTRL+X (down)
  180.  
  181. 15.One hand editing:
  182.    -----------------
  183.    In the editor it is now possible to do mark-block, cut block and
  184.    paste-block with the same hand.  CTRL+B = mark block.  CTRL+C =
  185.    cut block.  CTRL+F or CTRL+P = fill/paste block.
  186.  
  187. 16.Rotating block:
  188.    ---------------
  189.    You have typed something, that is in exatly the wrong order. 
  190.    (the first line should be the last ect.ect.).  Mark the desired
  191.    block and press CTRL+R to rotate this block.
  192.  
  193. 17.Lowercase block:
  194.    ----------------
  195.    Mark a block and press CTRL+L.  All text is turned into lowercase.
  196.  
  197. 18.Uppercase block:
  198.    ----------------
  199.    Mark block and press CTRL+U.  Uppercase again.
  200.  
  201. 19.Copy block:
  202.    -----------
  203.    Mark block and press CTRL+X, the block is now copyed and you can
  204.    paste it every where.
  205.  
  206. 20.Delete EOL:
  207.    -----------
  208.    Press CTRL+D and the line is deleted from the cursor to the end of
  209.    line.
  210.  
  211. 21.Go to top of text:
  212.    ------------------
  213.    Press CTRL+T and you are at the top line of your source.
  214.  
  215. 22.Look in editor:
  216.    ---------------
  217.    Looking with the 'l' command finds text in you source.  Now this
  218.    function can be executed while editing.  Press CTRL+J in the
  219.    editor if you want to look for the same text once more.
  220.  
  221. **********************************************************************
  222.  
  223. New features in SEKA V3.2:
  224. --------------------------
  225.  
  226. 1. New super fast editor scrolling and updating.
  227.  
  228. 2. SHIFT+UP/DOWN arrows and CTRL+A/Z is optimized, jump more than
  229.    1000 lines/sec!!
  230.  
  231. 3. A bug in CTRL+J (repeat searching) is fixed. And this routine is
  232.    also optimized. The speed is now more than 2000 lines/sec.
  233.  
  234. 4. In Seka V3.0 HELP jumped 100 lines down + '~'. HELP in editor mode
  235.    is now displaying a CTRL+key help text in the menu-bar.
  236.  
  237. 5. CTRL+T jumps to top and toggles to bottom if the cursor is positioned
  238.    on the first line in the editor (Doing this does of course not
  239.    result in loosing a cutted block)
  240.  
  241. 6. Mark Block functions are now included on the F-keys.
  242.    Pressing SHIFT F1-F10 makes a mark
  243.    Without SHIFT  F1-F10 jumps to mark
  244.  
  245. 7. CTRL+G jumps to an other type of mark:
  246.  
  247.     Eg.    Type ;; in your source, at the start of one or more
  248.         subroutines.
  249.         Now press CTRL+G. The editor will now jump to the
  250.         next place in your source which reads ;;
  251.  
  252. 8. CTRL+R rotate has changed its place to CTRL+Y, leaving space for
  253.    a search+replace routine. Pressing CTRL+R activates a new feature:
  254.    input in the menu-bar.  You are met with the text:
  255.  
  256.         Search for :
  257.         Replace with :
  258.  
  259.    Just try it..
  260.  
  261. 9. CTRL+Q continues Search+Replace.
  262.  
  263. 10.CTRL+S searches for text, like the 'L'-look line command. Text is
  264.    entered in the menu bar like the Search+Replace feature. To
  265.    continue searching for the same text press CTRL+J as usual.
  266.  
  267. 11.CTRL+X unmarks block.
  268.  
  269. 12.CTRL+K tells which registers you use in a marked block. You must
  270.    beware that this routine doesn't check your subroutines and rom
  271.    calls. It only perform a normal text search. But it ignores text-
  272.    strings and labelnames.
  273.  
  274. 13.V-Dir now displayes the disk path name, and more charspace are
  275.    available for each filename.
  276.  
  277. 14.=M meets you with the question:
  278.  
  279.         ADD WORKSPACE MEMORY IN KBYTES>
  280.  
  281.    Type the amount and press return. More workspace is now added.
  282.  
  283. 15.=L nn, indicates number of lines in editor window.
  284.  
  285.         eg. =L 28   (28 lines)
  286.  
  287. 16.Typing '!'-quit confronts you with three options:
  288.  
  289.     Exit or Restart (Y/N/R)?
  290.  
  291.    Typing 'R' results in restarting the seka, instead of re-loading
  292.    it again.
  293.  
  294. 17.The ?-print command now print 32 bits seperated in 8 bit blocks.
  295.  
  296. 18.ALT+SPACE jumps to the beginning of the next word.
  297.  
  298. 19.Lines more than 74 chars long doesn't jam the display, instead the
  299.    char '»' is displayed at the end.
  300.  
  301. 20.RS, WS - Read/Write track. RT, WT-Read/Write track reads a track.
  302.    One track is 11 sectors. You are confronted with the text:
  303.  
  304.         RAM PTR>
  305.         DISK PTR>
  306.         LENGTH>
  307.  
  308. 21.CC - Calculate checksum. PLEASE notice that all direct disk access
  309.   is directed to df0:
  310.  
  311. 22.RO - read objekt is includes.
  312.  
  313. 23.At the command line CRSR+UP/DOWN does not only repeat the last
  314.    entered text, but the last 16.
  315.  
  316. 24.Seka can now be executed from the Workbench
  317.  
  318. 25.File length is now not only displayed in DEC, but not also in HEX.
  319.  
  320. 26.H-hunt can now search for both bytes, words and longwords.
  321.  
  322.     eg.    BEGIN>$fc0000
  323.         END>$ffffff
  324.         DATA>1234.l 'Hello' 34.w LABEL.l
  325.  
  326.    If you dont type anything byte size is default.
  327.  
  328. 27.Cut, Fill, Hunt breaks if nothing is typed, then you are asked to do
  329.    so. This prevent crashes.
  330.  
  331. 28.Writing to a disk with not enough diskspace, doesn't cause an
  332.    unvalidated disk. But leaves a deleteable file.
  333.  
  334. 29.SHIFT+LEFT/RIGHT Beginning/End of line.
  335.  
  336. 30.Output from the execute CLI command is again directed to the
  337.    AmigaDOS window.
  338.  
  339. Short summary of control commands:
  340.  
  341.                 CTRL+A    ; 100 lines up
  342.                 CTRL+B    ; Mark block
  343.                 CTRL+C    ; Cut block
  344.                 CTRL+D    ; Delete to end of lines
  345.                 CTRL+F    ; Paste block (fill)
  346.         CTRL+G  ; Go to special mark ;;
  347.                 CTRL+J    ; Cont. Search for text (jump)
  348.         CTRL+K  ; Show registers.
  349.                 CTRL+L    ; Lower case
  350.                 CTRL+O    ; Insert line
  351.         CTRL+P  ; Paste
  352.         CTRL+Q  ; Cont. replace
  353.                 CTRL+R    ; Replace
  354.         CTRL+S  ; Search
  355.         CTRL+T  ; Top/Bottom
  356.                 CTRL+U    ; Upper case
  357.                 CTRL+W    ; Write block to disk
  358.                 CTRL+X    ; Unmark block
  359.         CTRL+Y    ; Rotate block
  360.                 CTRL+Z    ; 100 lines down
  361.                 CTRL+[    ; ESC
  362.  
  363. Authers note:
  364. -------------
  365.    This is a new upgraded version of the SEKA assembler. The key
  366.    word in this seka is SPEED. The lousy editor, has been removed.
  367.    Use the cli-command Add44k or Add21k (onebpl) if you want more
  368.    programming space (not speed this time).  If you don't want the
  369.    CLI to be disabled while using the SEKA just type "RUN SEKA" in
  370.    your startup-sequence.
  371.  
  372.    If you have any comments or bugreports on this new Seka V3.2
  373.    please write to:
  374.  
  375.       Kefrens,  Poste Restante,  3450 Alleroed,  Denmark
  376.  
  377.